home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 46 / Amiga Format CD46 (1999-10-20)(Future Publishing)(GB)[!][issue 1999-12].iso / -serious- / hardware / porthandler / porthandler.doc < prev    next >
Text File  |  1999-09-06  |  3KB  |  76 lines
  1.  
  2.     port-handler v41.4
  3.         
  4. COPYRIGHT AND DISCLAIMER
  5.      port-handler v41 is copyrighted 1998 by Stephan Rupprecht. All 
  6.     rights reserved. This program is freeware, so no financial donations 
  7.      required. Redistribution allowed if the package is left unchanged.   
  8.      The author is not responsible for any damage caused by the use or 
  9.     misuse of this documentation and/or the program(s) it describes.
  10.  
  11.     port-handler is partly based on:
  12.     ComHandler.c (C) 1989, 1993 by Ralph Babel, Amiga Guru Book p.643ff
  13.     Port-Handler.asm (C) 1986 John A. Toebes, VIII (AmigaLibDisk #20)
  14.  
  15. REQUIREMENTS
  16.     Any Amiga® (compatible) computer with at least OS2.04.
  17.  
  18. DESCRIPTION
  19.     port-handler v41 replaces the original l:port-handler that manages
  20.     the AmigaDOS devices SERx:, PAR: and PRT:. In opposite to the original
  21.     handler my version allows you to create new dos devices that can
  22.     manage the ports of an i/o-board (pre v41 port-handlers didn't support
  23.     third-party parallel.devices). The following mountlist entry illustrates
  24.     how to create a new device called HPAR: that accesses hyperPAR.device 
  25.     (HyperCOM io-boards by VMC) for reading and writing.
  26.  
  27.     HPAR:
  28.     EHandler = L:port-handler
  29.     Stacksize = 1024
  30.     Priority = 5
  31.     Device = hyperPAR.device
  32.     Unit = 0
  33.     Flags = 0
  34.     Baud = 0 
  35.     #
  36.  
  37.     You must set Baud to 0 for parallel.devices because Mount always tells
  38.     port-handler to use a baudrate of 1200 when Baud is not specified!
  39.     Because of this port-handler thinks that it talks to a serial.device.
  40.         (For the advanced user: port-handler v41 tries to query the device
  41.      type first, so if it talks to a so-called newstyle device, it'll
  42.      automatically find out what kind of device it accesses).
  43.  
  44. INSTALLATION
  45.     All you need is to copy the file "port-handler" to your "L:" drawer.
  46.  
  47. SPECIAL THANKS GO TO
  48.     Stephan Riedelbeck for testing port-handler on his system and debugging.
  49.     Jens Gerrit Schröder for giving me the idea of rewriting the handler.
  50.     Thomas Richter for his help with the BCPL magic.
  51.  
  52. HISTORY
  53.     41.0  first public release
  54.     41.1  port-handler is a single file now. Thanks to Th. Richter for his
  55.           help.
  56.     41.2  Compiled/Optimized with GNUC. included dosdrivers for all HyperCOM
  57.           boards.
  58.     41.2a No changes, just added some new dosdrivers for the ioblix board by
  59.           RBM.
  60.     41.3  hmmm, can't remember :(
  61.     41.4  bug: handler no longer terminates before ACTION_DIE/CLOSE
  62.           arrives. Before the handler could terminate itself although it 
  63.           was still in use, this caused certain programs to wait forever 
  64.           (eg GoldEd) <Thomas Richter>.
  65.           bug: handler messed up double-buffered packets.
  66.           imp: added a timeout timer of 30seks.
  67.  
  68. AUTHOR
  69.     Stephan Rupprecht
  70.     Apfeldweg 1
  71.     D-44359 Dortmund
  72.     Germany
  73.  
  74.     email:
  75.     stephan.rupprecht@gmx.de
  76.